home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / lib / c / stdio / Stdio_Setup.c < prev    next >
C/C++ Source or Header  |  1990-10-12  |  3KB  |  86 lines

  1. /* 
  2.  * Stdio_Setup.c --
  3.  *
  4.  *    Source code for the "Stdio_Setup" library procedure.
  5.  *
  6.  * Copyright 1988 Regents of the University of California
  7.  * Permission to use, copy, modify, and distribute this
  8.  * software and its documentation for any purpose and without
  9.  * fee is hereby granted, provided that the above copyright
  10.  * notice appear in all copies.  The University of California
  11.  * makes no representations about the suitability of this
  12.  * software for any purpose.  It is provided "as is" without
  13.  * express or implied warranty.
  14.  */
  15.  
  16. #ifndef lint
  17. static char rcsid[] = "$Header: /sprite/src/lib/c/stdio/RCS/Stdio_Setup.c,v 1.2 90/10/11 22:10:13 kupfer Exp $ SPRITE (Berkeley)";
  18. #endif not lint
  19.  
  20. #include "stdio.h"
  21.  
  22. /*
  23.  *----------------------------------------------------------------------
  24.  *
  25.  * Stdio_Setup --
  26.  *
  27.  *    This procedure is called by a client to initialize the information
  28.  *    associated with a stream.  This procedure is used by special-purpose
  29.  *    clients that provide their own low-level I/O;  for normal file I/O,
  30.  *    use fopen, freopen, or fdopen.
  31.  *
  32.  * Results:
  33.  *    None.
  34.  *
  35.  * Side effects:
  36.  *    The contents of stream are modified to set up for buffered I/O.
  37.  *    After this call has been made, the stream may be used in other
  38.  *    calls (e.g. getc and putc) to actually perform I/O.
  39.  *
  40.  *----------------------------------------------------------------------
  41.  */
  42.  
  43. void
  44. Stdio_Setup(stream, readable, writable, buffer, bufferSize, readProc,
  45.     writeProc, closeProc, clientData)
  46.     register FILE * stream;    /* Stream to be initialized. */
  47.     int readable;        /* Non-zero means stream is to be readable.  */
  48.     int writable;        /* Non-zero means stream is to be writable.
  49.                  * It's OK for a stream to be both readable
  50.                  * and writable.
  51.                  */
  52.     unsigned char *buffer;    /* Pointer to buffer space for the stream.
  53.                  * NULL means the stream will initially be
  54.                  * unbuffered. */
  55.     int bufferSize;        /* Size of buffer area. */
  56.     void (*readProc) _ARGS_((FILE *stream));
  57.                 /* Procedure to perform input for stream. */
  58.     void (*writeProc) _ARGS_((FILE *stream, Boolean flush));
  59.                 /* Procedure to perform output for stream. */
  60.     int (*closeProc) _ARGS_((FILE *stream));
  61.                 /* Procedure to close stream.  NULL means
  62.                  * there aren't any stream-dependent actions
  63.                  * to perform on close. */
  64.     ClientData clientData;    /* Client-specific information to store in
  65.                  * stream. */
  66. {
  67.     stream->lastAccess        = buffer-1;
  68.     stream->readCount        = 0;
  69.     stream->writeCount        = 0;
  70.     stream->buffer        = buffer;
  71.     stream->bufSize        = bufferSize;
  72.     stream->readProc        = readProc;
  73.     stream->writeProc        = writeProc;
  74.     stream->closeProc        = closeProc;
  75.     stream->clientData        = clientData;
  76.     stream->status        = 0;
  77.     stream->flags        = 0;
  78.     if (readable) {
  79.     stream->flags |= STDIO_READ;
  80.     }
  81.     if (writable) {
  82.     stream->flags |= STDIO_WRITE;
  83.     stream->writeCount = bufferSize;
  84.     }
  85. }
  86.